Shareware Grab Bag

home *** CD-ROM | disk | FTP | other *** search

/ Shareware Grab Bag / Shareware Grab Bag.iso / 090 / mhtb.arc / M

Wrap

Text File | 1988-02-27 | 16.3 KB | 354 lines

The MicroHelp Toolbox $79 + $3 s/h Compatible with QuickBASIC 2-4 and BASCOM 6 (Real Mode). (Ordering info is at the end of this file) Don't reinvent the wheel! Now you can "build" your programs instead of writing them. From MicroHelp, the publisher of Mach 2 and Stay-Res, our newest product is a library of QuickBASIC subprograms and functions that drastically reduce your programming time, while giving your programs a crisp, professional look and feel. As a bonus, we include a routine that lets you set the DOS Errorlevel from any version of QB as well as BASCOM 6. Because many of the routines are video oriented, we've built in a few routines from our Mach 2 assembly language library in order to speed up your programs. Since all of the subprograms and functions are written in QuickBASIC, and you get all the QB source code*, you can modify them to your heart's content. We even suggest specific modifications in the huge, easy-to-use, fully indexed manual. If our description doesn't convince you to order, send us a check for $5 (refundable on direct purchase of any of our products) and we'll send you a demo disk that will convince you that you need The MicroHelp Toolbox! What You See is What You Get ---------------------------- In addition to the manual, you get four diskettes containing: QB source code, a pre-built User Library for QB 2 and 3, a Quick Library for QB 4 and BASCOM 6, plus four LINK libraries (BCOM and BRUN for QB 2/3 and QB 4). We also include .MAK files and declarations for QB 4 as well as batch files for maintaining and rebuilding libraries. Each routine has a small sample program demonstrating its use and, as with all MicroHelp products, we offer free, full-time technical support (but you probably won't need it). We've Simplified On-Line Help, Macros, Screen Save and More. ------------------------------------------------------------ All of the input and selection subprograms call the same routine for fetching characters from the keyboard. That means you can add on-line help, macro processing, automatic monitor blanking, or even display the keyboard shift state by modifying only one module! Simplified CALL Syntax! ----------------------- There's no need to include a complicated CALL to our subprograms. Instead, we include a special file for each subprogram that you can $Include. Simply set your variables and GOSUB to our routine. You can also use CALL, if you prefer. * Source code for the DOS Errorlevel and the supporting assembly language subroutines from our Mach 2 package is not included. Selection Subprograms ---------------------------------------------------------------------- Pulldown Combines Pick123 and PickFromBox to give your programs pulldown menus, just like QuickBASIC. All you need to do is create DATA statements, choose your colors and GOSUB to our routine! Pick123 Select an item from a list like Lotus 1-2-3. Move through the selections with the arrow keys or type in your choice. Optionally choose an item by pressing a single key. Automatic scrolling when you have more items than can be viewed in the window. You can optionally display a message associated with each selection. PickFromBox1 Select one item from a boxed window using the arrow and page keys. Optionally choose an item by pressing a single letter associated with the item. Automatic scrolling when you have more items than can be viewed in the window. TagBox1 Select ("tag") as many items as you like from a boxed window. Automatic scrolling when you have more items than can be viewed in the window. Ideal for selecting files to be copied or backed up or anytime multiple selections are required. InverseWindow1 Use the arrow keys to highlight a block on the screen. Note 1: Automatic screen save on entry, and restore on exit, is optional. ---------------------------------------------------------------------- Input Subprograms StringInput Edited string input, with full use of the standard editing keys. Provide the user with a "default" string to be edited or let him start from scratch. This routine supports "editing masks" so that you can specifiy character types, required characters, non-entry characters, etc. Optional automatic input termination when the user has filled the field. You can even begin editing input at a location other than the first character! This routine is the foundation for the next three subprograms listed. FullScreenInput Fill out a data entry form where all fields appear on one screen. Each field has its own input mask (see StringInput) and you can optionally have data verification for special field types and required fields. The routine automatically moves the cursor around the screen according to the arrow and page key presses. SpreadSheetInput Cell oriented, this routine provides the user with a "one-record, one-line" approach to data entry, just like a spreadsheet. Automatic scrolling in all four directions is a standard feature. You can have the user begin editing at any cell in the data array and you can even specify at what character in the cell that editing should commence. If you want, this routine will display labels for the columns and rows! VirtualScreenInput This routine is similar to FullScreenInput, but it allows you to have a "virtual" data entry form that is larger than the screen. The subprogram automatically scrolls in all four directions and we provide you with sample REMmed code that will display arrows indicating in which direction(s) the user can find more data. CapsOn Turns the Caps Lock state on. CapsOff Turns the Caps Lock state off. InsertOn Turns the Insert state on. InsertOff Turns the Insert state off. NumOn Turns the Num Lock state on. NumOff Turns the Num Lock state off. ScrollOn Turns the Scroll Lock state on. ScrollOff Turns the Scroll Lock state off. KeyboardClear Clears the keyboard. ---------------------------------------------------------------------- DisplaySubprograms ExplodingBox Display an exploding box better than you've seen it done before. We can even display data inside the box as it grows, giving the effect of opening a window on underlying data! You can have sound effects, a "shadow" and even a box title. You control the speed at which the box grows. AreaClear Clear an area of the display instantly. EndOfLine Clear to the end of the line instantly. EndOfScreen Clear to the end of the screen instantly. BeginningOfLine Clear to the beginning of a line instantly. BeginningOfScreen Clear to the beginning of the screen instantly. MonitorOff Turn monitor(s) off for automatic screen blanking when the keyboard is idle. Works with one or two monitors. MonitorOn Turn monitor(s) on again. Cursor Get the current size & state of the cursor. ---------------------------------------------------------------------- Sound Subprograms SpeakerOn Turn the speaker on. SpeakerOff Turn the speaker off. Glissando Generate wierd and wonderful sounds through the speaker - much better than QB's SOUND statement. ErrorBuzzer Use Glissando to create your own "signature" sound effects when the user makes an error. ---------------------------------------------------------------------- String Subprograms BinaryChop Quickly search a sorted array for a string, where the match is at the first character. BinaryChopMid Quickly search a sorted array for a string, where the match is at some character other than the first. Parse Parse parameters from a string. Extract Extract data from "LINE INPUT #" statements. Ideal for parsing data from a sequential file. Replace Replace a substring (part of a string) with another string. ReplaceA Same as Replace, but for arrays. Count Count the number of words in a string. CountA Count the number of words in a string array. ---------------------------------------------------------------------- Btrieve Subprograms BtrieveCreate Create an empty data base file. BtrieveFileSize Calculate the theoretical size of a file given the number of records you specify. BtrievePageSize Calculate the optimum page size for a data base. This results in minimizing the disk space used. BtrieveFileStatus Similar to the output from B$UTIL. ---------------------------------------------------------------------- Miscellaneous Subprograms CopyFile Copy a file fast (requires QB 4 or BASCOM 6). TickDelay Delay system operations for n ticks. This routine is machine independent - you get the same result on a PC, XT, AT, 386 or Jr. Stuffkey Stuff characters into the keyboard buffer. Great for executing other programs or batch files when your program ends. You can even create batch files "on the fly" and then reinvoke your own program. SetTime2 Set the time in the CMOS chip on 286/386 machines. GetTime Get the time from the CMOS chip on 286/386 machines. SetDate2 Set the date in the CMOS chip on 286/386 machines. GetDate Get the date from the CMOS chip on 286/386 machines. SearchVolume Search an entire volume (an entire drive) for a file. As fast as Norton's FileFind! No error trapping necessary. WhatComputer Determine the machine on which your program is running. GetDirectory Read the file directory from any drive and path into an array. You can specify the drive, path and file specification, including wild cards. You also specify the file attributes to search for, including "read-only", "hidden" "volume label" and "system". No error trapping necessary. AverageInteger3 Find the average value from an array. HighInteger3 Find the high value from in an array. LowInteger3 Find the low value in an array. LptSwap Swaps logical printers so that output can be redirected to up to four printers via LPT1. ComSwap Swaps logical COM ports so that I/O can be handled on four COM ports via COM1. Note 2: This allows you to reset the CMOS chip values without a "setup" program and without rebooting. Note 3: The integer array routines are easily modifiable for other array types and multiple dimensions. ---------------------------------------------------------------------- Date Functions ToJulian Converts a string to a four byte Julian date. FromJulian Converts a Julian date to a string. DateDiff Returns the number of days between two dates. DayMath Adjust a date (string) by a number of days. MonthMath Adjust a date (string) by a number of months. YearMath Adjust a date (string) by a number of years. MonthLong Returns the full name of a month from a number. MonthShort Returns the three letter abbreviation of a month name from a number. DayLong Returns the full name of a day from a number. DayShort Returns the three letter abbreviation of a day name from a number. DayOfWeek Returns the day of the week from integer input (Month%, Day% and Year%). DayOfWeek2 Returns the day of the week from string input. RomDate Returns the system ROM date. ---------------------------------------------------------------------- Time Functions ToSeconds Converts a string of the time to the number of seconds past midnight. FromSeconds Converts seconds past midnight to a time string. TimeDiff Calculates the difference between two times. HoursMath Adjust a time by a number of hours. MinutesMath Adjust a time by a number of minutes. SecondsMath Adjust a time by a number of seconds. ---------------------------------------------------------------------- Keyboard Functions AltIsPressed Indicates if the Alt key is pressed or not. CtrlIsPressed Indicates if the Ctrl key is pressed or not. RightShiftIsPressed Indicates if the Right Shift Key is being pressed. LeftShiftIsIsPressed Indicates if the Left Shift key is being pressed. InsertIsPressed Indicates if the Ins key is being pressed. CapsLockIsPressed Indicates if the Caps Lock key is being pressed. NumLockIsPressed Indicates if the Num Lock key is being pressed. ScrollLockIsPressed Indicates if the Scroll Lock key is being pressed. InsertIsOn Indicates if Insert state is on or off. CapsLockIsOn Indicates if Caps Lock state is on or off. NumLockIsOn Indicates if Num Lock state is on or off. ScrollLockIsOn Indicates if Scroll Lock state is on or off. FetchKey Wait until the user presses one of the keys in a list that you pass. FetchExtendedKey Wait until the user presses one of the extended keys in a list that you pass. ---------------------------------------------------------------------- String Functions CenterString Center a string within another string. FullName Strips trailing blanks and returns a full name when you supply the first and last names. PadString Pad a string to a new length with your choice of characters. RightTrim Strip trailing blanks from a string. ---------------------------------------------------------------------- Miscellaneous Functions Exist Determine if a file exists without error trapping. BitIsOn Determines if any of 16 bits is on in an integer. This lets you use a single integer (two bytes) for 16 "flags". If you use integers in your program to indicate "on/off" situations, this can save a great deal of memory. ToggleBit Toggle any of 16 bits in an integer. If the bit is "on", it is set to "off" and vice versa. TurnBitOn Turn on any of 16 bits in an integer. TurnBitOff Turn off any of 16 bits is 0, it is set to WhichRecord LptStat Returns the status of any of four printers. ComStat Returns the status of any of four COM ports. Ansixxxx Thirteen ANSI functions. Especially useful with communications programs. ColorAttribute Color attribute calculation for the input and display routines. ---------------------------------------------------------------------- 30 Day Guarantee ---------------- If our software doesn't do what we advertise, and we don't fix it within 10 working days, you get a refund of your purchase price. System Requirements ------------------- IBM PC, XT, AT, PS/2, 80386 or 100% compatible. A hard disk with available disk space of approximately: 1.00 MB for QB 2/3 only 1.25 MB for QB 4/BASCOM 6 only 1.75 MB for for all supported compilers Please note that the disk space above presumes 2k cluster size. PC-DOS or MS-DOS 2.1 or later 80 Column monitor 360K floppy disk. We also have the product available on 3.5" diskettes. There is a $10 charge for this service. Ordering Information -------------------- To order, call MicroHelp toll-free at 1-800-922-3383. In GA, call (404) 973-9272. We welcome VISA, MasterCard and COD orders. (COD in USA only - please add $3) You can also order by mail. Send your check for $82 to: MicroHelp, Inc. 2220 Carlyle Drive Marietta GA 30062 For Canadian orders, the shipping and handling charge is $5. For all countries other than Canada and the USA, the charge is $18.